package com.cencat.route.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.route.entity.Route;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 路由Mapper接口
 * 
 * @author cencat
 * @version 1.0
 * @since 2024-12-19
 */
@Mapper
public interface RouteMapper extends BaseMapper<Route> {

    /**
     * 分页查询路由列表
     * 
     * @param page 分页对象
     * @param routeStatus 路由状态
     * @param routeType 路由类型
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 路由列表
     */
    IPage<Route> selectRoutePage(IPage<Route> page, 
                                @Param("routeStatus") Integer routeStatus,
                                @Param("routeType") Integer routeType,
                                @Param("startTime") LocalDateTime startTime,
                                @Param("endTime") LocalDateTime endTime);

    /**
     * 根据起点和终点查询路由
     * 
     * @param startLongitude 起点经度
     * @param startLatitude 起点纬度
     * @param endLongitude 终点经度
     * @param endLatitude 终点纬度
     * @param radius 搜索半径(公里)
     * @return 路由列表
     */
    List<Route> selectRoutesByPoints(@Param("startLongitude") Double startLongitude,
                                    @Param("startLatitude") Double startLatitude,
                                    @Param("endLongitude") Double endLongitude,
                                    @Param("endLatitude") Double endLatitude,
                                    @Param("radius") Double radius);

    /**
     * 根据路由编码查询路由
     * 
     * @param routeCode 路由编码
     * @return 路由信息
     */
    Route selectByRouteCode(@Param("routeCode") String routeCode);

    /**
     * 查询热门路由
     * 
     * @param limit 限制数量
     * @param days 天数
     * @return 热门路由列表
     */
    List<Route> selectPopularRoutes(@Param("limit") Integer limit,
                                   @Param("days") Integer days);

    /**
     * 查询最近路由
     * 
     * @param longitude 经度
     * @param latitude 纬度
     * @param radius 搜索半径(公里)
     * @param limit 限制数量
     * @return 最近路由列表
     */
    List<Route> selectNearbyRoutes(@Param("longitude") Double longitude,
                                  @Param("latitude") Double latitude,
                                  @Param("radius") Double radius,
                                  @Param("limit") Integer limit);

    /**
     * 统计路由数量
     * 
     * @param routeStatus 路由状态
     * @param routeType 路由类型
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 路由数量
     */
    Long countRoutes(@Param("routeStatus") Integer routeStatus,
                    @Param("routeType") Integer routeType,
                    @Param("startTime") LocalDateTime startTime,
                    @Param("endTime") LocalDateTime endTime);

    /**
     * 查询路由统计数据
     * 
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计数据
     */
    List<Map<String, Object>> selectRouteStatistics(@Param("startTime") LocalDateTime startTime,
                                                    @Param("endTime") LocalDateTime endTime);

    /**
     * 更新路由状态
     * 
     * @param routeId 路由ID
     * @param routeStatus 路由状态
     * @param updateTime 更新时间
     * @return 影响行数
     */
    int updateRouteStatus(@Param("routeId") Long routeId,
                         @Param("routeStatus") Integer routeStatus,
                         @Param("updateTime") LocalDateTime updateTime);

    /**
     * 更新路由使用次数
     * 
     * @param routeId 路由ID
     * @param updateTime 更新时间
     * @return 影响行数
     */
    int updateRouteUsageCount(@Param("routeId") Long routeId,
                             @Param("updateTime") LocalDateTime updateTime);

    /**
     * 批量更新路由状态
     * 
     * @param routeIds 路由ID列表
     * @param routeStatus 路由状态
     * @param updateTime 更新时间
     * @return 影响行数
     */
    int batchUpdateRouteStatus(@Param("routeIds") List<Long> routeIds,
                              @Param("routeStatus") Integer routeStatus,
                              @Param("updateTime") LocalDateTime updateTime);

    /**
     * 查询路由使用统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 使用统计
     */
    Map<String, Object> selectRouteUsageStats(@Param("routeId") Long routeId,
                                              @Param("startTime") LocalDateTime startTime,
                                              @Param("endTime") LocalDateTime endTime);

    /**
     * 查询路由性能统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 性能统计
     */
    Map<String, Object> selectRoutePerformanceStats(@Param("routeId") Long routeId,
                                                    @Param("startTime") LocalDateTime startTime,
                                                    @Param("endTime") LocalDateTime endTime);

    /**
     * 查询路由评价统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 评价统计
     */
    Map<String, Object> selectRouteRatingStats(@Param("routeId") Long routeId,
                                               @Param("startTime") LocalDateTime startTime,
                                               @Param("endTime") LocalDateTime endTime);

    /**
     * 查询路由排行榜
     * 
     * @param type 排行类型 1-使用次数 2-平均评分 3-平均时长
     * @param limit 限制数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 排行榜数据
     */
    List<Map<String, Object>> selectRouteRanking(@Param("type") Integer type,
                                                 @Param("limit") Integer limit,
                                                 @Param("startTime") LocalDateTime startTime,
                                                 @Param("endTime") LocalDateTime endTime);

    /**
     * 智能路由推荐
     * 
     * @param startLongitude 起点经度
     * @param startLatitude 起点纬度
     * @param endLongitude 终点经度
     * @param endLatitude 终点纬度
     * @param routeType 路由类型
     * @param limit 限制数量
     * @return 推荐路由列表
     */
    List<Map<String, Object>> selectSmartRouteRecommendation(@Param("startLongitude") Double startLongitude,
                                                             @Param("startLatitude") Double startLatitude,
                                                             @Param("endLongitude") Double endLongitude,
                                                             @Param("endLatitude") Double endLatitude,
                                                             @Param("routeType") Integer routeType,
                                                             @Param("limit") Integer limit);

    /**
     * 查询路由拥堵情况
     * 
     * @param routeId 路由ID
     * @return 拥堵情况
     */
    Map<String, Object> selectRouteCongestionInfo(@Param("routeId") Long routeId);

    /**
     * 更新路由拥堵状态
     * 
     * @param routeId 路由ID
     * @param congestionLevel 拥堵等级
     * @param updateTime 更新时间
     * @return 影响行数
     */
    int updateRouteCongestionStatus(@Param("routeId") Long routeId,
                                   @Param("congestionLevel") Integer congestionLevel,
                                   @Param("updateTime") LocalDateTime updateTime);

}